========== STEP 1 — meta init (fresh project) ==========

Initialized metaobjects/ + .metaobjects/ + metaobjects.config.ts
Codegen generators copied to codegen/generators/ — they're YOURS to edit (ADR-0034 scaffold-and-own).

Next steps (when later sub-projects ship):
  meta ingest        # propose entities from your existing TS code
  meta gen           # codegen TS targets from entities
  meta docs          # neutral model docs (entity + template pages, incl. linked template source)
  meta serve         # local viewer
  meta install-hooks # register MCP server + Claude Code hooks

exit 0

========== STEP 2 — owned generators copied into the consumer repo (codegen/generators/) ==========

--- codegen/generators/barrel.ts (header) ---
// REFERENCE TEMPLATE — copy this into your repo (e.g. codegen/generators/barrel.ts) and own it.
// Then import it LOCALLY in metaobjects.config.ts instead of from the package:
//   import { barrel } from "./codegen/generators/barrel";

--- codegen/generators/entity.ts (header) ---
// REFERENCE TEMPLATE — copy this into your repo (e.g. codegen/generators/entity.ts) and own it.
// Then import it LOCALLY in metaobjects.config.ts:
//   import { entityFile } from "./codegen/generators/entity";

--- codegen/generators/queries.ts (header) ---
// REFERENCE TEMPLATE — copy this into your repo (e.g. codegen/generators/queries.ts) and own it.
// Then import it LOCALLY in metaobjects.config.ts:
//   import { queriesFile } from "./codegen/generators/queries";

--- codegen/generators/routes.ts (header) ---
// REFERENCE TEMPLATE — copy this into your repo (e.g. codegen/generators/routes.ts) and own it.
// Then import it LOCALLY in metaobjects.config.ts:
//   import { routesFile } from "./codegen/generators/routes";

========== STEP 3 — scaffolded metaobjects.config.ts imports the OWNED local generators ==========
import { defineConfig } from "@metaobjectsdev/cli";
// Owned codegen generators (ADR-0034 scaffold-and-own). `meta init` copied these
// reference templates into ./codegen/generators/ — they are YOURS to edit, and
// `meta gen` runs from these local copies, not from the package. Read each file's
// header doc-block for what it emits and how to customize it.
import { entityFile } from "./codegen/generators/entity";
import { queriesFile } from "./codegen/generators/queries";
import { routesFile } from "./codegen/generators/routes";
import { barrel } from "./codegen/generators/barrel";

export default defineConfig({
  outDir:    "src/generated",
  extStyle:  "none",
  dbImport:  "../db",
  dialect:   "sqlite",
  apiPrefix: "",     // set to "/api" if your routes mount under /api
  generators: [
    entityFile(),
    queriesFile(),
    routesFile(),
    barrel(),
  ],
  docs: {
    outDir:   "./docs",        // model + api surfaces both land here (run: meta docs)
    layout:   "flat",          // or "package" for multi-package models
    surfaces: ["model", "api"],
  },
});


========== STEP 4 — author a sample entity, then `meta gen` (run from project root) ==========
gen[4]{file,status}:
  src/generated/Product.ts,new
  src/generated/Product.queries.ts,new
  src/generated/Product.routes.ts,new
  src/generated/index.ts,new
summary: 4 written
help[2]: typecheck the generated code with `npx tsc`,run schema with `meta migrate --db <url> --slug <name>`
exit 0

========== STEP 5 — generated output (emitted by the OWNED local generators) ==========
generated files: ["Product.queries.ts","Product.routes.ts","Product.ts","index.ts"]

--- src/generated/Product.queries.ts ---
// @generated by @metaobjectsdev/codegen-ts — DO NOT EDIT.
// Source metadata: Product (Product)
// Customize via Product.extra.ts in this directory (additional queries, custom logic).
import { eq } from "drizzle-orm";

import type { BaseSQLiteDatabase } from "drizzle-orm/sqlite-core";
type Db = BaseSQLiteDatabase<"sync" | "async", unknown>;

import { type Product, ProductInsertSchema, products } from "./Product";
export async function findProductById(
  db: Db,
  id: number,
): Promise<Product | null> {
  const [product] = await db
    .select()
    .from(products)
    .where(eq(products.id, id))
    .limit(1);
  return product ?? null;
}
export async function listProducts(
  db: Db,
  opts?: { limit?: number; offset?: number },
): Promise<Product[]> {
  let q = db.select().from(products).$dynamic();
  if (opts?.limit !== undefined) {
    q = q.limit(opts.limit);
  }
  if (opts?.offset !== undefined) {
    q = q.offset(opts.offset);
  }
  return q;
}
export async function createProduct(db: Db, data: unknown): Promise<Product> {
  const validated = ProductInsertSchema.parse(data);
  const [product] = await db.insert(products).values(validated).returning();
  return product!;
}
export async function updateProduct(
  db: Db,
  id: number,
  data: unknown,
): Promise<Product | null> {
  const validated = ProductInsertSchema.partial().parse(data);
  const [product] = await db
    .update(products)
    .set(validated)
    .where(eq(products.id, id))
    .returning();
  return product ?? null;
}
export async function deleteProductById(db: Db, id: number): Promise<boolean> {
  // Use .returning() unconditionally — supported on SQLite ≥3.35 (covers D1, libsql/Turso)
  // and Postgres. Result is an array of deleted rows; presence implies success.
  const deleted = await db
    .delete(products)
    .where(eq(products.id, id))
    .returning();
  return deleted.length > 0;
}

--- src/generated/Product.routes.ts ---
// @generated by @metaobjectsdev/codegen-ts — DO NOT EDIT.
// Source metadata: Product (Product)
// Customize via Product.extra.ts in this directory (e.g., auth, additional handlers).
import { db } from "../db";
import {
  Product,
  ProductFilterAllowlist,
  ProductInsertSchema,
  products,
  ProductSortAllowlist,
  ProductUpdateSchema,
} from "./Product";
import { mountCrudRoutes } from "@metaobjectsdev/runtime-ts/drizzle-fastify";
import type { FastifyInstance } from "fastify";

/**
 * Mount the 5 standard REST endpoints for Product using Drizzle directly.
 *
 * Customize: register this as-is for stock CRUD, OR import the per-verb
 * helpers (mountListRoute, mountGetRoute, ...) from
 * @metaobjectsdev/runtime-ts/drizzle-fastify and mix with your own handlers
 * (auth, side effects, etc.).
 */
export async function productRoutes(fastify: FastifyInstance) {
  mountCrudRoutes({
    fastify,
    path: Product.$path,
    db,
    table: products,
    insertSchema: ProductInsertSchema,
    updateSchema: ProductUpdateSchema,
    filterAllowlist: ProductFilterAllowlist,
    sortAllowlist: ProductSortAllowlist,
    dialect: "sqlite",
  });
}

--- src/generated/Product.ts ---
// @generated by @metaobjectsdev/codegen-ts — DO NOT EDIT.
// Source metadata: Product (Product)
// Customize via Product.extra.ts in this directory.
import { z } from "zod";

export interface Product {
  id?: number;
  name?: string;
  priceCents?: number;
}
export const ProductInsertSchema = z.object({
  id: z.number().int().optional(),
  name: z.string().optional(),
  priceCents: z.number().int().optional(),
});

--- src/generated/index.ts ---
// @generated by @metaobjectsdev/codegen-ts — DO NOT EDIT.
export * from "./Product";


========== STEP 6 — re-run `meta init --force` after hand-editing an owned generator ==========

Initialized metaobjects/ + .metaobjects/ + metaobjects.config.ts
Codegen generators copied to codegen/generators/ — they're YOURS to edit (ADR-0034 scaffold-and-own).

Next steps (when later sub-projects ship):
  meta ingest        # propose entities from your existing TS code
  meta gen           # codegen TS targets from entities
  meta docs          # neutral model docs (entity + template pages, incl. linked template source)
  meta serve         # local viewer
  meta install-hooks # register MCP server + Claude Code hooks

exit 0
hand-edit survived --force: YES